Node / meshtastic / Meshtastic-Android / files / androidApp / src / google / kotlin / org / meshtastic / app / translation / MlKitMessageTranslator.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.app.translation

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787com.google.mlkit.common.model.DownloadConditions

Tff7b72import T7ee787com.google.mlkit.common.model.RemoteModelManager

Tff7b72import T7ee787com.google.mlkit.nl.languageid.LanguageIdentification

Tff7b72import T7ee787com.google.mlkit.nl.languageid.LanguageIdentifier

Tff7b72import T7ee787com.google.mlkit.nl.translate.TranslateLanguage

Tff7b72import T7ee787com.google.mlkit.nl.translate.TranslateRemoteModel

Tff7b72import T7ee787com.google.mlkit.nl.translate.Translation

Tff7b72import T7ee787com.google.mlkit.nl.translate.TranslatorOptions

Tff7b72import T7ee787kotlinx.coroutines.suspendCancellableCoroutine

Tff7b72import T7ee787org.meshtastic.feature.messaging.translation.DownloadResult

Tff7b72import T7ee787org.meshtastic.feature.messaging.translation.MessageTranslationService

Tff7b72import T7ee787org.meshtastic.feature.messaging.translation.TranslationResult

Tff7b72import T7ee787kotlin.coroutines.cancellation.CancellationException

Tff7b72import T7ee787kotlin.coroutines.resume

T8b949e/**

* ML Kit-powered chat message translation for the Google flavor.

*

* Detects the source language on-device, then translates to the target locale. Unlike [MlKitDocTranslator], missing

* language models (~30MB each) are never downloaded implicitly — [translate] reports them via

* [TranslationResult.ModelDownloadRequired] so the UI can ask the user first, then calls [downloadLanguageModels].

*/

Tff7b72class T56d364MlKitMessageTranslator Tb4b4b4: Te6edf3MessageTranslationService Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3modelManager Tff7b72= Te6edf3RemoteModelManagerTb4b4b4.Te6edf3getInstanceTb4b4b4(Tb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8fftranslateTb4b4b4(Te6edf3textTb4b4b4: Tffa657StringTb4b4b4, Te6edf3targetLocaleTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3TranslationResult Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3textTb4b4b4.Te6edf3isBlankTb4b4b4(Tb4b4b4)Tb4b4b4) Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tff7b72val Te6edf3targetLang Tff7b72=

Te6edf3TranslateLanguageTb4b4b4.Te6edf3fromLanguageTagTb4b4b4(Te6edf3normalizeLanguageTagTb4b4b4(Te6edf3targetLocaleTb4b4b4)Tb4b4b4)

Tff7b72?: Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tff7b72val Te6edf3detectedTag Tff7b72= Te6edf3identifySourceLanguageTb4b4b4(Te6edf3textTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3detectedTag Tff7b72=Tff7b72= Te6edf3UNDETERMINED_LANGUAGE_TAGTb4b4b4) Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tff7b72val Te6edf3sourceLang Tff7b72=

Te6edf3TranslateLanguageTb4b4b4.Te6edf3fromLanguageTagTb4b4b4(Te6edf3normalizeLanguageTagTb4b4b4(Te6edf3detectedTagTb4b4b4)Tb4b4b4) Tff7b72?: Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tff7b72if Tb4b4b4(Te6edf3sourceLang Tff7b72=Tff7b72= Te6edf3targetLangTb4b4b4) Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3NotRequired

Tff7b72val Te6edf3missing Tff7b72= Te6edf3listOfTb4b4b4(Te6edf3sourceLangTb4b4b4, Te6edf3targetLangTb4b4b4)Tb4b4b4.Te6edf3filterNot Tb4b4b4{ Te6edf3isModelDownloadedTb4b4b4(Tffa657itTb4b4b4) Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3missingTb4b4b4.Te6edf3isNotEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3ModelDownloadRequiredTb4b4b4(Te6edf3missingTb4b4b4, Te6edf3ESTIMATED_MODEL_SIZE_MB Tff7b72* Te6edf3missingTb4b4b4.Te6edf3sizeTb4b4b4)

Tb4b4b4}

Tff7b72return Tff7b72try Tb4b4b4{

Tff7b72val Te6edf3options Tff7b72=

Te6edf3TranslatorOptionsTb4b4b4.Te6edf3BuilderTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3setSourceLanguageTb4b4b4(Te6edf3sourceLangTb4b4b4)Tb4b4b4.Te6edf3setTargetLanguageTb4b4b4(Te6edf3targetLangTb4b4b4)Tb4b4b4.Te6edf3buildTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3translator Tff7b72= Te6edf3TranslationTb4b4b4.Te6edf3getClientTb4b4b4(Te6edf3optionsTb4b4b4)

Tff7b72val Te6edf3translated Tff7b72=

Tff7b72try Tb4b4b4{

Te6edf3suspendCancellableCoroutine Tb4b4b4{ Te6edf3cont Tff7b72-Tff7b72>

Te6edf3translator

Tb4b4b4.Te6edf3translateTb4b4b4(Te6edf3textTb4b4b4)

Tb4b4b4.Te6edf3addOnSuccessListener Tb4b4b4{ Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Tffa657itTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3addOnFailureListener Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72>

Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3tag Tff7b72= Te6edf3TAGTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffTranslation failed: Tffd700${Te6edf3eTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4}

Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Tff7b72nullTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4} Tff7b72finally Tb4b4b4{

Te6edf3translatorTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4)

Tb4b4b4}

Te6edf3translatedTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3TranslationResultTb4b4b4.Te6edf3SuccessTb4b4b4(Tffa657itTb4b4b4) Tb4b4b4} Tff7b72?: Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3CancellationExceptionTb4b4b4) Tb4b4b4{

Tff7b72throw Te6edf3e

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3ExceptionTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3tag Tff7b72= Te6edf3TAGTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffTranslation to Tffd700$Te6edf3targetLocaleTa5d6ff failed: Tffd700${Te6edf3eTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4}

Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tb4b4b4}

Tb4b4b4}

T8b949e/** Available means ML Kit can translate into [locale], even if the model still needs downloading. */

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffisLanguageAvailableTb4b4b4(Te6edf3localeTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72=

Te6edf3TranslateLanguageTb4b4b4.Te6edf3fromLanguageTagTb4b4b4(Te6edf3normalizeLanguageTagTb4b4b4(Te6edf3localeTb4b4b4)Tb4b4b4) Tff7b72!Tff7b72= Tff7b72null

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffdownloadLanguageModelsTb4b4b4(Te6edf3languageTagsTb4b4b4: Te6edf3ListTff7b72<Tffa657StringTff7b72>Tb4b4b4)Tb4b4b4: Te6edf3DownloadResult Tb4b4b4{

Te6edf3languageTagsTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3tag Tff7b72-Tff7b72>

Tff7b72val Te6edf3lang Tff7b72=

Te6edf3TranslateLanguageTb4b4b4.Te6edf3fromLanguageTagTb4b4b4(Te6edf3normalizeLanguageTagTb4b4b4(Te6edf3tagTb4b4b4)Tb4b4b4)

Tff7b72?: Tff7b72return Te6edf3DownloadResultTb4b4b4.Te6edf3FailedTb4b4b4(Ta5d6ff"Ta5d6ffUnsupported language: Tffd700$Te6edf3tagTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3downloadModelTb4b4b4(Te6edf3langTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3result Tff7b72is Te6edf3DownloadResultTb4b4b4.Te6edf3FailedTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3tag Tff7b72= Te6edf3TAGTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffModel download for Tffd700$Te6edf3tagTa5d6ff failed: Tffd700${Te6edf3resultTb4b4b4.Te6edf3reasonTffd700}Ta5d6ff" Tb4b4b4}

Tff7b72return Te6edf3result

Tb4b4b4}

Tb4b4b4}

Tff7b72return Te6edf3DownloadResultTb4b4b4.Te6edf3Success

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffidentifySourceLanguageTb4b4b4(Te6edf3textTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3client Tff7b72= Te6edf3LanguageIdentificationTb4b4b4.Te6edf3getClientTb4b4b4(Tb4b4b4)

Tff7b72return Tff7b72try Tb4b4b4{

Te6edf3suspendCancellableCoroutine Tb4b4b4{ Te6edf3cont Tff7b72-Tff7b72>

Te6edf3client

Tb4b4b4.Te6edf3identifyLanguageTb4b4b4(Te6edf3textTb4b4b4)

Tb4b4b4.Te6edf3addOnSuccessListener Tb4b4b4{ Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Tffa657itTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3addOnFailureListener Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72>

Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3tag Tff7b72= Te6edf3TAGTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffLanguage identification failed: Tffd700${Te6edf3eTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4}

Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Te6edf3UNDETERMINED_LANGUAGE_TAGTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4} Tff7b72finally Tb4b4b4{

Te6edf3clientTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffdownloadModelTb4b4b4(Te6edf3langTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3DownloadResult Tb4b4b4{

Tff7b72val Te6edf3model Tff7b72= Te6edf3TranslateRemoteModelTb4b4b4.Te6edf3BuilderTb4b4b4(Te6edf3langTb4b4b4)Tb4b4b4.Te6edf3buildTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3conditions Tff7b72= Te6edf3DownloadConditionsTb4b4b4.Te6edf3BuilderTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3buildTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3suspendCancellableCoroutine Tb4b4b4{ Te6edf3cont Tff7b72-Tff7b72>

Te6edf3modelManager

Tb4b4b4.Te6edf3downloadTb4b4b4(Te6edf3modelTb4b4b4, Te6edf3conditionsTb4b4b4)

Tb4b4b4.Te6edf3addOnSuccessListener Tb4b4b4{ Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Te6edf3DownloadResultTb4b4b4.Te6edf3SuccessTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3addOnFailureListener Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72> Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Te6edf3DownloadResultTb4b4b4.Te6edf3FailedTb4b4b4(Te6edf3eTb4b4b4.Te6edf3message Tff7b72?: Ta5d6ff"Ta5d6ffDownload failedTa5d6ff"Tb4b4b4)Tb4b4b4) Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffisModelDownloadedTb4b4b4(Te6edf3langTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72= Te6edf3suspendCancellableCoroutine Tb4b4b4{ Te6edf3cont Tff7b72-Tff7b72>

Tff7b72val Te6edf3model Tff7b72= Te6edf3TranslateRemoteModelTb4b4b4.Te6edf3BuilderTb4b4b4(Te6edf3langTb4b4b4)Tb4b4b4.Te6edf3buildTb4b4b4(Tb4b4b4)

Te6edf3modelManager

Tb4b4b4.Te6edf3isModelDownloadedTb4b4b4(Te6edf3modelTb4b4b4)

Tb4b4b4.Te6edf3addOnSuccessListener Tb4b4b4{ Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Tffa657itTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3addOnFailureListener Tb4b4b4{ Te6edf3contTb4b4b4.Te6edf3resumeTb4b4b4(Tff7b72falseTb4b4b4) Tb4b4b4}

Tb4b4b4}

T8b949e/** ML Kit expects modern ISO 639-1 codes; Android's [java.util.Locale] can emit legacy ones. */

Tff7b72private Tff7b72fun Td2a8ffnormalizeLanguageTagTb4b4b4(Te6edf3tagTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Tff7b72when Tb4b4b4(Te6edf3tagTb4b4b4) Tb4b4b4{

Ta5d6ff"Ta5d6ffiwTa5d6ff" Tff7b72-Tff7b72> Ta5d6ff"Ta5d6ffheTa5d6ff"

Ta5d6ff"Ta5d6ffinTa5d6ff" Tff7b72-Tff7b72> Ta5d6ff"Ta5d6ffidTa5d6ff"

Ta5d6ff"Ta5d6ffjiTa5d6ff" Tff7b72-Tff7b72> Ta5d6ff"Ta5d6ffyiTa5d6ff"

Tff7b72else Tff7b72-Tff7b72> Te6edf3tag

Tb4b4b4}

Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72const Tff7b72val Te6edf3TAG Tff7b72= Ta5d6ff"Ta5d6ffMlKitMessageTranslatorTa5d6ff"

Tff7b72private Tff7b72const Tff7b72val Te6edf3ESTIMATED_MODEL_SIZE_MB Tff7b72= T79c0ff3T79c0ff0

Tff7b72private Tff7b72val Te6edf3UNDETERMINED_LANGUAGE_TAG Tff7b72= Te6edf3LanguageIdentifierTb4b4b4.Te6edf3UNDETERMINED_LANGUAGE_TAG

Tb4b4b4}

Tb4b4b4}